home *** CD-ROM | disk | FTP | other *** search
/ Windows Expert / Windows Expert.iso / windownt / rcsdoc.zip / RCSFILE.TXT < prev    next >
Text File  |  1991-11-10  |  7KB  |  196 lines
  1.  
  2.  
  3. RCSFILE(5)                 Unix Programmer's Manual                 RCSFILE(5)
  4.  
  5.  
  6. NNNAAAMMMEEE
  7.      rcsfile - format of RCS file
  8.  
  9. DDDEEESSSCCCRRRIIIPPPTTTIIIOOONNN
  10.      An RCS file's contents are described by the grammar below.  The  text  is
  11.      free format: space, backspace, tab, newline, vertical tab, form feed, and
  12.      carriage return (collectively, _w_h_i_t_e _s_p_a_c_e) have no  significance  except
  13.      in  strings.   Strings  are  enclosed by @@@.  If a string contains a @@@, it
  14.      must be doubled; otherwise, strings may contain arbitrary binary data.
  15.  
  16.      The meta syntax uses  the  following  conventions:  `|'  (bar)  separates
  17.      alternatives;  `{' and `}' enclose optional phrases; `{' and `}*' enclose
  18.      phrases that may be repeated zero or more times;  `{'  and  '}+'  enclose
  19.      phrases  that  must  appear  at  least once and may be repeated; Terminal
  20.      symbols are in bbbooollldddfffaaaccceee; nonterminal symbols are in _i_t_a_l_i_c_s.
  21.  
  22.      rcstext          ::=  admin {delta}* desc {deltatext}*
  23.  
  24.      admin            ::=  head            {num};
  25.                            { branch        {num}; }
  26.                            access          {id}*;
  27.                            symbols         {id : num}*;
  28.                            locks           {id : num}*;  {strict  ;}
  29.                            { comment       {string}; }
  30.                            { expand        {string}; }
  31.                            { newphrase }*
  32.  
  33.      delta            ::=  num
  34.                            date            num;
  35.                            author          id;
  36.                            state           {id};
  37.                            branches        {num}*;
  38.                            next            {num};
  39.                            { newphrase }*
  40.  
  41.      desc             ::=  desc            string
  42.  
  43.      deltatext        ::=  num
  44.                            log             string
  45.                            { newphrase }*
  46.                            text            string
  47.  
  48.      num              ::=  {digit{.}}+
  49.  
  50.      digit            ::=  0 | 1 | ... | 9
  51.  
  52.      id               ::=  letter{idchar}*
  53.  
  54.      letter           ::=  any letter
  55.  
  56.      idchar           ::=  any visible graphic character except special
  57.  
  58.      special          ::=  $ | , | . | : | ; | @
  59.  
  60.  
  61.  
  62.  
  63.  
  64.                                     \*(Dt                                    1
  65.  
  66.  
  67.  
  68. RCSFILE(5)                 Unix Programmer's Manual                 RCSFILE(5)
  69.  
  70.  
  71.      string           ::=  @{any character, with @ doubled}*@
  72.  
  73.      newphrase        ::=  id word* ;
  74.  
  75.      word             ::=  id | num | string | :
  76.  
  77.      Identifiers are case sensitive.  Keywords are in lower  case  only.   The
  78.      sets  of  keywords and identifiers may overlap.  In most environments RCS
  79.      uses the ISO 8859/1 encoding:  letters are octal codes 101-132,  141-172,
  80.      300-326,  330-366  and  370-377,  visible  graphic  characters  are codes
  81.      041-176 and 240-377, and white space characters  are  codes  010-015  and
  82.      040.
  83.  
  84.      The  _n_e_w_p_h_r_a_s_e  productions  in  the  grammar  are  reserved  for  future
  85.      extensions  to the format of RCS files.  No _n_e_w_p_h_r_a_s_e will begin with any
  86.      keyword already in use.
  87.  
  88.      The _d_e_l_t_a nodes form a tree.  All nodes whose numbers consist of a single
  89.      pair  (e.g.,  2.3,  2.1,  1.3,  etc.)   are  on the trunk, and are linked
  90.      through the nnneeexxxttt field in order of decreasing numbers.  The hhheeeaaaddd field in
  91.      the  _a_d_m_i_n  node  points to the head of that sequence (i.e., contains the
  92.      highest pair).  The bbbrrraaannnccchhh node in the admin node indicates  the  default
  93.      branch  (or  revision)  for  most  RCS operations.  If empty, the default
  94.      branch is the highest branch on the trunk.
  95.  
  96.      All _d_e_l_t_a nodes  whose  numbers  consist  of  2_n  fields  (_n\(=_2)  (e.g.,
  97.      3.1.1.1,  2.1.2.2,  etc.)   are linked as follows.  All nodes whose first
  98.      2_n-1 number fields are identical are linked through  the  nnneeexxxttt  field  in
  99.      order  of  increasing  numbers.   For  each such sequence, the _d_e_l_t_a node
  100.      whose number is identical to the first 2_n-2 number fields of  the  deltas
  101.      on that sequence is called the branchpoint.  The bbbrrraaannnccchhheeesss field of a node
  102.      contains a list of the numbers of the first nodes of  all  sequences  for
  103.      which it is a branchpoint.  This list is ordered in increasing numbers.
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                     \*(Dt                                    2
  130.  
  131.  
  132.  
  133. RCSFILE(5)                 Unix Programmer's Manual                 RCSFILE(5)
  134.  
  135.  
  136.      Example:
  137.  
  138.                                 Head
  139.                                   |
  140.                                   |
  141.                                   v                        / \
  142.                               ---------                   /   \
  143.         / \          / \      |       |      / \         /     \
  144.        /   \        /   \     |  2.1  |     /   \       /       \
  145.       /     \      /     \    |       |    /     \     /         \
  146.      /1.2.1.3\    /1.3.1.1\   |       |   /1.2.2.2\   /1.2.2.1.1.1\
  147.      ---------    ---------   ---------   ---------   -------------
  148.          ^            ^           |           ^             ^
  149.          |            |           |           |             |
  150.          |            |           v           |             |
  151.         / \           |       ---------      / \            |
  152.        /   \          |       \  1.3  /     /   \           |
  153.       /     \         ---------\     /     /     -----------
  154.      /1.2.1.1\                  \   /     /1.2.2.1\
  155.      ---------                   \ /      ---------
  156.          ^                        |           ^
  157.          |                        |           |
  158.          |                        v           |
  159.          |                    ---------       |
  160.          |                    \  1.2  /       |
  161.          ----------------------\     /---------
  162.                                 \   /
  163.                                  \ /
  164.                                   |
  165.                                   |
  166.                                   v
  167.                               ---------
  168.                               \  1.1  /
  169.                                \     /
  170.                                 \   /
  171.                                  \ /
  172.  
  173.                                 Fig. 1: A revision tree
  174.  
  175. IIIDDDEEENNNTTTIIIFFFIIICCCAAATTTIIIOOONNN
  176.      Author: Walter F. Tichy, Purdue University, West Lafayette, IN, 47907.
  177.      Revision Number: 5.0; Release Date: 1990/08/22.
  178.      Copyright (c) 1982, 1988, 1989 by Walter F. Tichy.
  179.      Copyright (c) 1990 by Paul Eggert.
  180.  
  181. SSSEEEEEE AAALLLSSSOOO
  182.      ci(1), co(1), ident(1), rcs(1), rcsdiff(1), rcsmerge(1), rlog(1),
  183.      Walter F. Tichy, RCS--A System for Version Control, _S_o_f_t_w_a_r_e--_P_r_a_c_t_i_c_e  &
  184.      _E_x_p_e_r_i_e_n_c_e 111555, 7 (July 1985), 637-654.
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.                                     \*(Dt                                    3
  195.  
  196.